home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / bstring.man < prev    next >
Encoding:
Text File  |  1992-04-23  |  1.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4. BSTRING               C Library Procedures                BSTRING
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      bcopy, bcmp, bzero, ffs - bit and byte string operations
  10.  
  11. SSYYNNOOPPSSIISS
  12.      #include <bstring.h>
  13.  
  14.      bbccooppyy((ssrrcc,, ddsstt,, lleennggtthh))
  15.      cchhaarr **ssrrcc,, **ddsstt;;
  16.      iinntt lleennggtthh;;
  17.  
  18.      bbccmmpp((bb11,, bb22,, lleennggtthh))
  19.      cchhaarr **bb11,, **bb22;;
  20.      iinntt lleennggtthh;;
  21.  
  22.      bbzzeerroo((bb,, lleennggtthh))
  23.      cchhaarr **bb;;
  24.      iinntt lleennggtthh;;
  25.  
  26.      ffffss((ii))
  27.      iinntt ii;;
  28.  
  29. DDEESSCCRRIIPPTTIIOONN
  30.      The functions _b_c_o_p_y, _b_c_m_p, and _b_z_e_r_o operate on variable
  31.      length strings of bytes.  They do not check for null bytes
  32.      as the routines in _s_t_r_i_n_g(3) do.
  33.  
  34.      _B_c_o_p_y copies _l_e_n_g_t_h bytes from string _s_r_c to the string _d_s_t.
  35.  
  36.      _B_c_m_p compares byte string _b_1 against byte string _b_2, return-
  37.      ing zero if they are identical, non-zero otherwise.  Both
  38.      strings are assumed to be _l_e_n_g_t_h bytes long.  BBccmmpp of _l_e_n_g_t_h
  39.      zero bytes always returns zero.
  40.  
  41.      _B_z_e_r_o places _l_e_n_g_t_h 0 bytes in the string _b_1.
  42.  
  43.      _F_f_s finds the first bit set in the argument passed it and
  44.      returns the index of that bit.  Bits are numbered starting
  45.      at 1, from the right.  A return value of 0 indicates the
  46.      value passed is zero.
  47.  
  48. BBUUGGSS
  49.      The _b_c_o_p_y routine take parameters backwards from _s_t_r_c_p_y.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0             November 18, 1987                       1
  64.  
  65.  
  66.  
  67.